home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / program / 245 / dialogcs.doc < prev    next >
Text File  |  1988-10-10  |  9KB  |  326 lines
  1.  
  2.                       DIALOG CONSTRUCTION SET
  3.  
  4.                        Derrick Anthony Hall 
  5.                           Copyright 1988
  6.                         All rights reserved   
  7.                          Shareware Product  
  8.  
  9.   Dialog Construction Set, the resource editor for the rest of us, is 
  10.  
  11. written completely in GFA BASIC. The premise behind this program was
  12.  
  13. to create an RCS editor that would provide ease of use and offer
  14.  
  15. flexability at the sametime. This program was fully tested on the
  16.  
  17. 520 and 1040ST, with old and new roms.
  18.  
  19.                           THE DCS EDITOR
  20.  
  21.   If you have used Degas or any other paint programs, you'll feel at home 
  22.  
  23. within DCS editor. All that is needed on your part is a little
  24.  
  25. creativity. DCS does not support predesign GEM like dialog boxes, you
  26.  
  27. the user have to create them yourself. The DCS editor operates is
  28.  
  29. all three ST resolution modes.
  30.  
  31.   To get started double click on the filename "DIALOGCS.PRG", by doing
  32.  
  33. so you'll be launched into the DCS editor. The editor is very straight
  34.  
  35. forward, nothing to memorized.
  36.                                                  
  37.                           MENU FUNCTIONS
  38.  
  39. DIALOG Box:-Create up to 100 GEM dialog boxes. Press left mouse to draw
  40. box, release to position. The option will be given to either ADD, DELETE or
  41. CANCEL the dialog box that was been postioned. The CANCEL alert button only
  42. returns control back to the menu bar.
  43.  
  44. TOUCHEXIT Button:-Create up to 50 active exit buttons. Press left mouse to
  45. draw button, release to postion. When the button is positioned, you'll be
  46. given the option to add TEXT or DELETE button. TEXT, allows you to give a
  47. name to the button you're creating. DELETE, completely removes the button
  48. from the work screen. 
  49.  
  50. RADIO Button:-Create up to 50 active radio buttons. Press left mouse to
  51. draw button, release to postion. When the button is positioned. You'll be
  52. given the option to add TEXT or DELETE button. TEXT, allows you to give a
  53. name to the button you're creating. DELETE, completely removes the button
  54. from the work screen. 
  55.  
  56. HELP:-Gives a brief discription on all the menu commands.
  57.  
  58. CLEAR SCREEN:-Clear work area.
  59.  
  60. SAVE:-Generates .LST file to be merged inside GFA BASIC interpreter.
  61.  
  62. DELETE:-Trash unwanted files on diskette.
  63.  
  64. WRITE DIALOG TEXT:-Write text to be positioned within dialog box area.
  65.  
  66. ON ACCESSORIES:-Activate accessory menu for selection.
  67.  
  68. OFF ACCESSORIES:-Deactivate accessory menu
  69.  
  70. QUIT:-Exit to GEM desktop
  71.  
  72.  
  73.  
  74.                          GFA BASIC KEYWORDS
  75.  
  76.   To change text font and color use the DEFTEXT keyword within GFA BASIC
  77.  
  78. see below.
  79.  
  80.   DEFTEXT c,s,r,g : "c" represents the number of preselected color
  81.  
  82. registers, high res 0 to 1, medium res 0 to 3, and low res 0 to 15.
  83.  
  84. "s" defines the style to be used by deftext, 0=normal, 1=bold face
  85.                                
  86. 2=light, 4=italic, 8=underlined, 16=outlined and 24=underlined &
  87.  
  88. outline. "r" defines the rotation angle, 0=normal, 900=90 degrees,
  89.  
  90. 1800=180 degrees and 2700=270 degrees. "g" defines the height of the
  91.  
  92. characters in graphic dots,4=very small, 6=standard(color), 
  93.  
  94. 13=standard(monochrome) and 32=enlarged.
  95.                                                               
  96.   DEFLINE is used to set the line size and pattern. This is useful
  97.  
  98. if you wish to highlight an default button box.
  99.  
  100.   DEFFILL will be one of the most used GFA BASIC keywords within DCS
  101.  
  102. generated code, when modifying dialog boxes to be filled with patterns
  103.  
  104. or colors.
  105.  
  106.  
  107.                    EDITABLE DIALOG BOX ROUTINE
  108.   
  109.   Print At(20,10);"Name   :"+Space$(25)
  110.  
  111.   Print At(20,11);"Address:"+Space$(25)
  112.  
  113.   Print At(20,12);"City   :"+Space$(25)
  114.  
  115.   Print At(20,13);"State  :"+Space$(25)
  116.  
  117.   Print At(20,14);"Zip    :"+Space$(25)
  118.  
  119.   Print At(29,10);
  120.  
  121.   Form Input 25,Name$
  122.  
  123.   Print At(29,11);
  124.  
  125.   Form Input 25,Address$
  126.  
  127.   Print At(29,12);
  128.  
  129.   Form Input 25,City$
  130.  
  131.   Print At(29,13);
  132.  
  133.   Form Input 25,State$
  134.  
  135.   Print At(29,14);
  136.  
  137.   Form Input 25,Szip$
  138.                                                      
  139.  
  140.  
  141. They're many ways to create an edit routine for
  142.  
  143. homemade dialog boxes, for a excellent demo see page 49 of the new
  144.  
  145. GFA BASIC BOOK from Michtron, Inc.
  146.                                  
  147.                                                   
  148.                    GROW AND SHRINK VISUAL EFFECT
  149.  
  150.  
  151.      In every DCS generated .LST file you'll find an routine call
  152.  
  153. "Shrink_grow". This routine is used to achieve the visual opening and
  154.  
  155. closing effect when each dialog box is selected and closed. You can call
  156.  
  157. this routine by doing the following:
  158.       
  159.  
  160.          @Shrink_grow(Gem,lightx,lighty,wsgx,hsgy,lox,loy,wx,hy)
  161.  
  162.  
  163. GEM=1 open grow effect 
  164.  
  165. GEM=0 close shrink effect
  166.  
  167. Lightx,lighty=X,Y location of the shrink and grow box
  168.  
  169. wsgx, hsgy=width and height of the shrink and grow box
  170.  
  171. lox, loy=X,Y location of the dialog box
  172.  
  173. wx,hy=width and height of the dialog box
  174.     
  175.                                                                                                      
  176.                         COMPLEX DIALOG BOXES 
  177.  
  178.   One of the ways to create complex dialog boxes, is to use your ST
  179.  
  180. monitor screen has a template. I'm sure it can be done in other ways,
  181.  
  182. since the screen template is easier and works best. Before designing any
  183.  
  184. complex dialog boxes, you should have an idea on the type of dialog box
  185.  
  186. you wish to create. A template is necessary if you wish to position
  187.  
  188. buttons and dialog boxes properly. All that is needed is
  189.  
  190. a soft tip magic marker to draw points on monitor screen. This will
  191.                                   
  192. guide you in creating boxes in a more precision layed out manner.
  193.  
  194. After you have gotten  use to the editor and designing dialog and 
  195.  
  196. button boxes, this unorthodox screen template won't be necessary.
  197.  
  198. Credit boxes are the easiest to create within any RCS editor, for all
  199.  
  200. that is needed is an dialog outline and an active button box. 
  201.  
  202.                                             
  203.                         RESET BACK TO NORMAL
  204.  
  205.   If you should modify the Dialog Construction Set generated .LST file
  206.  
  207. code to accept different fill patterns and fonts, reset the GFA BASIC
  208.  
  209. commands back to normal. It is very important that you reset these
  210.  
  211. keywords or else your dialog box outcome won't be pleasing.
  212.  
  213.  
  214.      Set text font                Reset text font back to normal
  215.  
  216.     DEFTEXT 2,1,0,6                 DEFTEXT 1,0,0,6(color mode)
  217.  
  218.     DEFTEXT 1,1,0,32                DEFTEXT 1,0,0,13(monochrome mode)
  219.  
  220.      Set line pattern             Reset line pattern back to normal
  221.  
  222.     DEFLINE 1,10,2,1                DEFLINE 1,1,0,0
  223.  
  224.      Set fill pattern             Reset fill pattern back to normal
  225.  
  226.     DEFFILL 1,2,2                   DEFFILL 0,1,1   
  227.  
  228.                                                   
  229.  
  230.           CALLING DCS DIALOG BOX ROUTINE WITHIN YOUR PROGRAM
  231.  
  232.   When you have completed your dialog boxes within DCS editor, marge
  233.  
  234. the .LST file inside GFA BASIC editor. To actually use or call your
  235.  
  236. procedure you will have to use one of the following methods:
  237.  
  238.  
  239.        @DIALOG_BOX
  240.        
  241.          or
  242.       
  243.        GOSUB DIALOG_BOX
  244.  
  245.                               
  246.                          ASCII CODES
  247.  
  248.    How to obtain various ST ASCII symbols and characters within Dialog
  249.  
  250. Construction Set text editor. These symbols and characters may serve
  251.  
  252. useful when designing dialog boxes and GEM like windows. 
  253.  
  254.   Alternate-Control-E ( Close window symbol )                             
  255.  
  256.           "        -F ( Resize window symbol
  257.  
  258.           "        -I ( Clock symbol )
  259.  
  260.           "        -O ( Atari right logo symbol )
  261.  
  262.           "        -D ( Left arrow )
  263.  
  264.           "        -G ( Open window symbol )
  265.  
  266.           "        -K ( Music symbol )
  267.  
  268.           "        -C ( Right arrow )                                
  269.  
  270.           "        -B ( Down arrow )
  271.  
  272.           "        -N ( Atari left logo symbol )
  273.           
  274.     Alternate-Shift-Z ( Quarter character symbol )
  275.  
  276.           Alternate-F3 ( Copyright symbol )
  277.  
  278.               "    -F4 ( Register symbol )
  279.  
  280.               "    -F5 ( Trade mark symbol )                
  281.  
  282.                                  
  283. Dialog Construction Set is an extremely powerful resource construction
  284.  
  285. set editor for GFA BASIC, but every effort was being made to keep it
  286.  
  287. very small in bytes and simple, yet powerful enough to satisfy most 
  288.  
  289. users. Hope you have fun using this program as I did writing it, enjoy.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.